GoldenEye Japanese Language Tools
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Important Note:
  First, the irony that this document is not in japanese has hardly escaped the writter.  Anyone with vastly more proficiency than I who would be willing to translate this--minus this message, obviously--please do so.

  Also, the kanji table is incomplete.  Anyone willing to identify the images in the font and update the two japanese language files is more than welcome to.  I'm afraid that japanese support on english keyboards leaves much to be desired.
  
-_-

  The GoldenEye Setup Editor, as of 4/20/2009, does not support japanese text.  However, it can import a binary you've already constructed.
  
  These tools convert binary language files into UTF-8 text files that can be editted and converted back into binaries.  You can then use the "inject file" feature to compress and add them into the ROM.
  The program uses langauge files in its directory in order to replace 8xxx and Cxxx values with text codes and vice-versa.  These come in pairs, such as "japanese.txt" for 8xxx values and "japaneselarge.txt" for Cxxx.  By default it looks for japanese, but if you alter the font you can create a new langauge file to reflect the changes.  If you do, make sure the Cxxx file ends "large.txt", ie. "myfle.txt" + "myfilelarge.txt".
  
+_+

Usage:
  There are two tools.  "GEtoUTF8.exe" creates UTF-8 text from binaries, and "UTF8toBIN.exe" turns these files back into binaries.  All parameters are optional, but valid commands for each are given here.  Dashes (-) or slashes (/) may be used before all command line options.
  
GEtoUTF8.exe <filename.bin> -l<language.txt> -q -n -f -?
  filename.bin
	Optional input filename
  -llanguage.txt
	Replacement language file.  By default, japanese.txt is used.
  -q
	Quiet mode, disabling most on-screen output, including errors.
  -n
	Disables line numbers
  -f
	Disables foreign characters; in other words, 8xxx and Cxxx characters.  Only ANSI characters from 0x20-0x7F will be displayed.
  -? or -H
	Displays these command line options.


UTF8toBIN.exe <filename.bin> -l<language.txt> -q -n -?
  filename.bin
	Optional input filename
  -llanguage.txt
	Replacement language file.  By default, japanese.txt is used.
  -q
	Quiet mode, disabling most on-screen output, including errors.
  -n
	Disables using line numbers to determine the entry number for the text.  Instead, each line of text is concidered one more consecutive entry.
  -? or -H
	Displays these command line options.


#_#

Writing Text:
  For the most part this is straight-forward.  You type text normally except in a few special cases.  First though, the file format:

0000	This is a line of text.\nFollowed by one on the next line\n
0001	This is a different text entry.

  The values on the left are the line numbers.  It is suggested you always use them, as this allows you to set what entry each line is set to.  Otherwise, they just go in order.
  After the line number is a tab.  There must be a tab after line numbers, and more importantly there should be no tabs except after line numbers.  GE doesn't use tabs, so neither should you.
  Each text entry should be written on one line.  An entry ends when you type a return (Enter).  For entries that display multiple lines on-screen--the mission briefing text, for instance--type "\n" where each line begins.  This is called a newline.

  There are other special characters besides newline.  These all start with the character \.  To type a "\", you will need to type two of them: "\\".
\\	\
\n	newline.  Displays following text on next line.
\l	large type, used to tell when Cxxx characters should be used
\s	standard type, used to stop writting Cxxx characters
\h	this must be followed by a 4-byte hex code for a value.  It is used as a placeholder when an entry hasn't been entered into the language file.

@_@

  Source is provided in the source folder.  Feel free to recode it as you see fit.  

-Zoinkity	(nefariousdogooder@yahoo.com)
